home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / prog_bas / vbscrape.zip / README.TXT < prev    next >
Text File  |  1994-05-11  |  7KB  |  201 lines
  1. ==============================================================
  2.  
  3.    Copyright 1994  Northeast Data Corp.  All Rights Reserved
  4.  
  5. ==============================================================
  6.  
  7.  
  8.                      Scraper VBX V1.1
  9.  
  10.  
  11. The Scraper VBX control allows you to extract data from another
  12. application. This is useful for integrating applications that cannot
  13. be integrated via DDE, OLE, or other means. The control operates by
  14. allowing the user to select a target window in a different application.
  15. By commanding the control, your application can extract data from the
  16. other application and use this data as it sees fit.
  17.  
  18. For example, to integrate imaging into a database application, you could
  19. write an image display application that uses the Scraper control. The
  20. Scraper control would allow the user to select a window in the database
  21. application that contains the file name of a .TIF file. When the user
  22. presses the VIEW button in your application, you command the Scraper 
  23. control to extract the file name from the database application window.
  24. Then you display the selected file in your application.
  25.  
  26. The Scraper control conforms to Visual Basic release 1.0, so it is
  27. compatible with Visual Basic versions 1.0, 2.0, 3.0 and higher,
  28. and with Visual C++ versions 1.0, 1.5 and higher. This control is also
  29. available from Northeast Data Corp. in the form of a C custom control 
  30. that works with the SDK Dialog Editor for use in C and C++ programs.
  31.  
  32. The only difference between the demo version of the control and
  33. the commercial version is that the demo version displays a
  34. dialog box that allows the user to register the control with
  35. Northeast Data. There are no other functional differences.
  36.  
  37.    
  38. ===================
  39. The demo version    
  40. ===================
  41. (Does not apply if you have purchased a licensed version)
  42.  
  43. The demo version of the control will allow you to perform all functions
  44. implemented by the commercial version. The only difference is that a
  45. registration dialog box is displayed when the control is first loaded.
  46.  
  47. By registering the control with Northeast Data Corp., you get:
  48.  
  49.    - The commercial version of the control
  50.    - A telephone and FAX number for support
  51.    - A Compuserve ID for support
  52.    - Free maintenance release updates
  53.    - A discount on major releases
  54.    - More information about using NetBIOS
  55.  
  56.  
  57. ===================
  58. System Requirements
  59. ===================
  60. Microsoft Windows version 3.0, 3.1 or higher.
  61.  
  62.  
  63. ===================
  64. Installation
  65. ===================
  66.  
  67. Copy the VBSCRAPER.VBX file to your Windows or Windows\System directory.
  68.  
  69. Start Windows and run Visual Basic or the PROJECT1.EXE program supplied
  70. with the Scraper control.
  71.  
  72. If you are running Visual Basic, you can load the PROJECT1.MAK file or
  73. load the Scraper control into your own project by using the "Add File"
  74. item under the FILE menu in Visual Basic.
  75.  
  76.  
  77. ===================
  78. Control Properties
  79. ===================
  80.  
  81. Action      
  82.  
  83.    0 - Get window text. Retrieves the caption from the target window.
  84.  
  85.    1 - Get button state. Returns "1" if a button is checked or "0" if
  86.        it is not checked. This applies to radio buttons and check boxes.
  87.  
  88.    2 - Get selected listox item. Returns the text for the current selected
  89.        item in a listbox.
  90.  
  91.    3 - Get edit text. Returns the text entered into an edit box. This action
  92.        also returns the text that is currently selected in a combo box.
  93.  
  94.  
  95. Command
  96.  
  97.    1 - Configure
  98.  
  99.       Displays a dialog box that allows the user to choose a window
  100.       to scrape. The only windows the user will be allowed to choose
  101.       are those owned by other applications.
  102.  
  103.    2 - Scrape
  104.  
  105.       Extracts the data from the target application window.
  106.  
  107. DragIcon    
  108.  
  109.       A standard Visual Basic property.
  110.  
  111. DragMode
  112.  
  113.       A standard Visual Basic property.
  114.  
  115. Index
  116.  
  117.       A standard Visual Basic property.
  118.  
  119. Left
  120.       A standard Visual Basic property.
  121.  
  122. Name
  123.  
  124.       A standard Visual Basic property.
  125.  
  126. ScrapeID
  127.  
  128.       The name that you assign to the window that is specified for scraping.
  129.       You can have several scraper controls on a form. Each control can 
  130.       scrape a single window in the target application. The ScrapeID 
  131.       is used to identify each target window.
  132.  
  133. Scraped
  134.  
  135.       The data that has been most recently scraped from the target window.
  136.  
  137. TabIndex
  138.  
  139.       A standard Visual Basic property.
  140.  
  141. TabStop
  142.  
  143.       A standard Visual Basic property.
  144.  
  145. Tag
  146.  
  147.       A standard Visual Basic property.
  148.  
  149. Top
  150.  
  151.       A standard Visual Basic property.
  152.  
  153. Visible
  154.  
  155.       A standard Visual Basic property.
  156.  
  157.  
  158. =============================
  159. General Notes
  160. =============================
  161. The "Target" application and "Target" window are those that are chosen by
  162. the user from the configuration dialog box. All information about the
  163. chosen window is stored in the scraper.ini file. The sections in this file
  164. are identified using the ScraperID property value.
  165.  
  166. The Scraper control stores all the information about the selected target
  167. window. When your application commands the Scraper to scrape the target
  168. window, the Scraper control tries to find the window that was specified
  169. during configuration (selection of the target window). Because there is
  170. no positive way to identify the target window (MS Windows does not keep
  171. specific window identifiers between application invocations), Scraper does
  172. the best it can to locate the desired window. Usually, it can locate the
  173. window based on its relationship to other task windows. If it cannot locate
  174. the window, it will return an error code to the application. The application
  175. will then have to prompt the user to re-select the desired window.
  176.  
  177. Data can only be scraped from a target application's windows. If the
  178. target application displays data without using standard Windows controls,
  179. there is no way Scraper can extract that data. For example, the 
  180. Microsoft Word and Excel applications do not display data in standard
  181. Windows controls (edit controls, etc.). Although you can extract data 
  182. from dialog boxes and other windows within these applications, you cannot
  183. extract data that is simply written to the screen.
  184.  
  185. The configuration dialog box displays information about the target window
  186. that is probably not useful to many users. This information is presented
  187. for those who may be able to use it.
  188.  
  189.  
  190.    ================================================================
  191.  
  192.       Northeast Data Corp.
  193.       2117 Buffalo Rd., Suite 290
  194.       Rochester, NY  14624
  195.       716-247-5934 (phone & FAX)
  196.  
  197.    ================================================================
  198.  
  199.    April 3, 1994
  200.  
  201.